home *** CD-ROM | disk | FTP | other *** search
/ Mac Mania 2 / MacMania 2.toast / Demo's / Tools&Utilities / JCONV-DD 1.5 / ReadMe - JCONV-DD < prev   
Encoding:
Text File  |  1993-11-12  |  9.0 KB  |  271 lines  |  [TEXT/ttxt]
  1. JCONV-DD -- a JIS<->SJIS<->EUC converter
  2. ========================================
  3. FILE: JCONV-DD
  4. ver.: 1.5
  5. Type: Application
  6. Author: Natsu Sakimura
  7. Date: 1993.11.12
  8. System Requirement: System 7.0 or later
  9. Distribution: Donateware(Freeware) (see Asking your favour: 
  10.               section below for terms and conditions) 
  11.  
  12. *** This document is formatted in SE-TEXT format. ***
  13. *** You can use EasyView for more convenient browsing ***
  14.  
  15.     =================
  16.     TABLE OF CONTENTS
  17.     =================
  18. Description:
  19. New In This Version:
  20. Usage:
  21. Result:
  22. Caution:
  23. Disclaimer:
  24. Contact address:
  25. Distribution
  26. Notes:
  27. Acknowledgement:
  28. Asking your favour:
  29. Version History:
  30. Future Directions:
  31. Other utilities from the same author
  32.  
  33. Description:
  34. ------------
  35.     JCONV-DD is a drag & drop application which performs 
  36.     the conversion of JIS, SJIS and EUC files. It 
  37.     auto-detects the encoding scheme of the file which was 
  38.     dropped.
  39.  
  40. New In This Version:
  41. --------------------
  42.     ver.1.5 now allows the default output code settings for 
  43.     New-JIS, Shift-JIS, EUC input files so that users do not 
  44.     need to specify neither input nor output code once the 
  45.     default has been set. 
  46.     
  47. Usage:
  48. ------
  49.  **    Before start using JCONV-DD version 1.5, users are 
  50.     strongly recommended to set up the default behavior for 
  51.     the JCONV-DD.
  52.     
  53.     To do so, just double click the JCONV-DD icon while 
  54.     pressing control key down until a dialog box appears. 
  55.     In the dialog box, you can set the default output 
  56.     code for each of JIS, SJIS, and EUC files. You can 
  57.     also set the creator code for the output file here.
  58.     
  59.     Once you have done the setup, just drag & drop one or
  60.     more text files onto JCONV-DD. JCONV-DD will automatically 
  61.     detect the input code, then converts the file according to 
  62.     the rule you have set in the preference dialog.
  63.     
  64.     To override the default behavior, press COMMAND_KEY while 
  65.     dropping the files. A dialog comes up and through it, 
  66.     you can set up the input and output code as you desire.
  67.     
  68.     You can also change the output file's code by pressing one of 
  69.     the modifier keys.
  70.     
  71.     ----------- --------------------------
  72.         Key         Output
  73.     ----------- --------------------------
  74.     SHIFT_KEY    SHIFT-JIS
  75.     OPTION_KEY   EUC
  76.     SPACE_KEY    New-JIS
  77.     COMMAND_KEY  Specify through dialog
  78.     CONTROL_KEY  Setup the preference**
  79.     ----------- --------------------------
  80.     
  81.  ** I strongly recommend you to setup the preference before you 
  82.     start using JCONV-DD. It will save a lot of time later.
  83.     
  84.     You must continue pressing the modifier key until the conversion 
  85.     of the first file begin. (All the other files will be converted 
  86.     to the same code as the first file.)
  87.     
  88.     You can also open the application and select the files from 
  89.     Standard File dialog, but it doesn't make much sense, 
  90.     does it? The modifier key strategy also works here.
  91.  
  92. Result:
  93. -------
  94.     File with the desired encoding: Default is New-JIS.
  95.     The name of the output file will have the extension 
  96.     showing its code. e.g., if the original file was 
  97.     myfile.txt, then output will be something like 
  98.      myfile.new  -- New JIS
  99.      myfile.sjs  -- Shift JIS
  100.      myfile.euc  -- EUC.
  101.      myfile.old  -- Old-JIS
  102.      myfile.nec  -- NEC-JIS
  103.      myfile.rem  -- JIS without ESC code
  104.     
  105.     If you select Check Code Only mode, JCONV-DD will display 
  106.     the file's code.
  107.     
  108. Caution:
  109. --------
  110.     It has not been tested much.
  111.     *** IT IS NOT COMPATIBLE WITH SYSTEMS PRIOR TO SYSTEM 7.0 ***
  112.     If you drop more than 2 files with the same filename except 
  113.     the extension (e.g., myfile.txt and myfile.org), it may cause 
  114.     an error because both file ends up in the same file name. 
  115.     It's just the problem of the file name creation. I am open to 
  116.     any suggestions. My present remedy is to add '.' at the end of 
  117.     original file names in such cases. I have written a drag&drop 
  118.     utility to do this (You can contact me if you want).
  119.  
  120. Disclaimer:
  121. ---------- 
  122.     THE PROGRAMME IS PROVIDED AS IS. ABSOLUTELY NO RESPONSIBILITY 
  123.     WILL BE TAKEN BY THE AUTHOR FOR WHATEVER THE CONSEQUENCE OF 
  124.     THIS APPLICATION.
  125.  
  126. Contact address:
  127. ----------------
  128.     Please e-mail any suggestions to:
  129.         sakimura@sscl.uwo.ca 
  130.  
  131. Distribution
  132. ------------
  133.     You can freely redistribute this package provided you do so in 
  134.     the original packaging, i.e., don't remove any file from the 
  135.     package. You must not charge any money for the redistribution 
  136.     except for the nominal charge for the disk, etc. 
  137.  
  138.     All the files are copyrighted and not in the public domain:
  139.     It is a freeware! 
  140.  
  141. Notes:
  142. ------ 
  143.     This version of JCONV-DD implements subset of jconv ver.3.0 
  144.     by Ken Lunde. I wrote this because, from time to time, I 
  145.     had to convert between sjis and jis files. I wanted to do it 
  146.     without much interaction. I thought a drag & drop with only 
  147.     a few options will be nice. 
  148.  
  149.     The features dropped from jconv ver.3.0 are:
  150.     i. JIS/EUC/SJIS table
  151.     ii. verbose mode
  152.     
  153. Acknowledgement:
  154. ----------------
  155.     I would like to thank Ken Lunde for making the source of 
  156.     jconv freely available. Also, I would like to thank Troy 
  157.     Anderson for supplying "File Dropper" application shell 
  158.     without any charge. 
  159.  
  160. Asking your favour:
  161. -------------------
  162.     Although this programme is free, if you liked it and 
  163.     decided to use it, you are encouraged to make donations 
  164.     to an organization like UNHCR or "Medicines sans Frontieres" 
  165.     to help peaople in needs.
  166.     
  167.     You can do it in 3 ways. 
  168.     
  169.     1) Find the organization near your place and donate. 
  170.        *** In this case, please send me the name and 
  171.        address of the organization to me. I am trying to 
  172.        compile a list of such organizations so that 
  173.        I can help people to get contact with these 
  174.        organizations easier. (In fact, the organization 
  175.        need not be for Bosnia. PLEASE STATE EXPLICITLY 
  176.        WHAT THE ORGANIZATION IS FOR!)
  177.     
  178.     2) Donate to the organizations in the attached list. 
  179.        (Unfortunately, the document lists only 2 organizations 
  180.        and is in Japanese. Please send me more addresses!)
  181.        
  182.     3) Send cheque or money order to me. Then, it will 
  183.        be forwarded to UNHCR in Ottawa. 
  184.        
  185.     In any case, please drop me a note to the following. 
  186.     If you have an e-mail address, you will get (though 
  187.     I do not guarantee) 
  188.       1) Bug report
  189.       2) Notice of new version release.
  190.     
  191.     Natsu Sakimura
  192.     1 Jacksway Cres., Suite 320
  193.     London, Ontario N5X 3T5
  194.     CANADA
  195.     
  196.     E-mail: sakimura@sscl.uwo.ca
  197.  
  198. Version History:
  199. ----------------
  200. 0.2b    The first release [1993.08.26].
  201. 1.3     The second release [1993.08.31]. New features:
  202.         • Added command mode to specify 
  203.        (1) Input Code [New-JIS, Old-JIS, NEC-JIS, EUC, Shift-JIS]
  204.        (2) Output Code [New-JIS, Old-JIS, NEC-JIS, EUC, Shift-JIS]
  205.        (3) Other modes:[JIS-Repair, Delete ESC, Force Delete ESC,
  206.              Hankaku to Zenkaku(To Full Size), Check Code Only]
  207.      • New algorithms which came with jconv ver.3.0.
  208.        [BTW, jconv 3.0 is available from info-mac archive 
  209.        in the util directory if I remember correctly. ]
  210. 1.4b1    The third release [1993.09.07]. 
  211.    • Disabled the progress bar for the smaller files (<5K).
  212.    • Disabled the "smooth" progress bar for the larger files.
  213.       These are for the sake of speed.
  214.    • Added behavior control mode, i.e., preference setting for 
  215.       default behavior of JCONV-DD.
  216.    • Added a modifier key to specify New-JIS for output to 
  217.       override the user setting.
  218.  
  219. 1.4b2    The Second evolution of version 1.4. 
  220.    • Changed the specification so that it will truncate the 
  221.      filename of the output when it is too long, so that now 
  222.      it works even for a very long file name. 
  223.  
  224. 1.4b3    The Third evolution of version 1.4. [1993.09.25]
  225.    • Fixed a bug which caused a crash in System7.0.1 when 
  226.      using in Command or preference mode. 
  227.  
  228. 1.4b5    [1993.10.18]
  229.    • Fixed a bug which did not allow it to process more 
  230.      than 7 files at a time.
  231.  
  232. 1.5.0    [1993.10.30]
  233.    • Changed the default behavior control dialog so that it is
  234.      now possible to change the default behavior according to 
  235.      the code of the input file. 
  236.      
  237. Future Directions:
  238. ------------------
  239. I am thinking of adding the following capabilities in the 
  240. future:
  241.  
  242. 1) CIS-JIS support.
  243. 2) In place conversion option.
  244.  
  245. Other utilities from the same author
  246. ------------------------------------
  247. CRLF : Converts file format among UNIX<->Mac<->IBM (well, more 
  248.        formally, changes the end of line character among 
  249.        LF<->CR<->CRLF) on Drag & Drop. It converts the file 
  250.        "in place", i.e., it does not create a new file with another 
  251.        extension. Instead of the extension, you will be able to 
  252.        figure out the file's format by the icon.
  253.        
  254.        It does not break up the Japanese code like 
  255.        some other similar utility does. You can set up the 
  256.        default behavior just like JCONV-DD, so you would not need 
  257.        the interaction after then. 
  258.        
  259.        Written in Think C ver.6.0. 
  260.        [Donateware] 
  261.        
  262. Phone Dialer: A no frill phone dialer. You input the tag (name) and 
  263.        phone number and store it. Phone dialer will play the dialing 
  264.        tone from mac's speaker when you choose a number from the 
  265.        stored list. It can deal with alpha-numeric phone number like 
  266.        1-800-NBA-DUNK or 1-800-TRY-AVIS. 
  267.        
  268.        Written in Serius Programmer. 
  269.        [Donateware]
  270.  
  271. <End of ReadMe>